home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 005 / stocks_1.arc / PLTSTKFL.DOC < prev    next >
Text File  |  1983-01-04  |  12KB  |  256 lines
  1.                        DOCUMENTATION FOR PLTSTKFL.BAS
  2.  
  3.                           Copyright 1983 BY Michael Csontos
  4.                                             3228 Livonia Center Road
  5.                                             Lima, New York 14485
  6.                                             January 4, 1983
  7.  
  8.  
  9.                               INTRODUCTION
  10.  
  11.       This  program  is  intended for use in making printer plots of securities
  12. (stock,  bonds,  options,  mutual  funds)  from  files  created  by the program
  13. MAKSTKFL.BAS  by  the  above author. It contains printer commands for the EPSON
  14. MX-80  printer.  The  special  GRAPHTRACK  feature used is SCRIPT (subscript or
  15. superscript) for high resolution plots. Medium resoluton plots should work with
  16. the IBM version of the printer.
  17.  
  18.       Several  files  which  should be on the same disk with this program. They
  19. are:
  20.  
  21.            PLTSTKFL.DOC      which you are now reading
  22.            PLTSEQFL.DAT      a list of files you want plotted automaticly
  23.            PLTSEQFL.ALL      a list of all files to edit to PLTSEQFL.DAT
  24.            MONEYMKT.INT      containing the inerest rate to be used in plots
  25.            ????????.DJA      data file created by MAKSTKFL
  26.            ????????.NYS      "    "    "       "  "
  27.            ????????.OTC      "    "    "       "  "
  28.            ????????.OPT      "    "    "       "  "
  29.            ????????.MUT      "    "    "       "  "
  30.  
  31.       The  program will run without these files, except that of course at least
  32. one data file must be present for it to do anything.
  33.  
  34.       The plots may be continuous over all of the data in the files or adjusted
  35. for  the  most  recent  data  that  will  fit on an eleven inch page. Each plot
  36. consists of a heading giving the date and time plotted, the type of data (price
  37. or  volume)  and  some  statistics  about  the data (average price, lowest low,
  38. highest high, percent range).
  39.  
  40.       No  scale is generated for the plots. Instead the data is referenced to a
  41. line based on the average closing price for the security and the daily price is
  42. printed  with  the  date on each line (or for every Friday in high resolution).
  43. The placement of the date and price is adjusted so that the price plot can take
  44. full advantage of the width of the paper.
  45.  
  46.       The  purpose  of this type of plot is to emphasize price movements rather
  47. than  to  show the value of a stock. The presence of the average value baseline
  48. with  the money market growth plot makes it easy to see when it would have been
  49. a good time to have bought or to have sold.
  50.  
  51.                              PROGRAM OPERATION
  52.  
  53.       When  the  program  is  run  it first checks for the presence of the file
  54. MONEYMKT.INT.  This  file  should contain a single number, the interest rate in
  55. percent,  to  be  used in all but options plots to show a compartatve growth in
  56. the  average  price  of  the  security  over  the time plotted. The file may be
  57. created or revised in DOS with EDLIN.
  58.  
  59.       If  the file MONEYMKT.INT is missing the program will ask you to enter an
  60. interest  rate for use for the current run. If you enter 0 or just press enter,
  61. the program will assume a rate of 10%
  62.  
  63.       The   program   next   checks   for  the  presence  of  PLTSEQFL.DAT  and
  64. PLTSTKFL.DOC.  If they are missing, the menu options requiring them are skipped
  65. in the displays to follow.
  66.  
  67.                              MENUS
  68.  
  69.       Four  menus  are  produced  by the program. The first selects the program
  70. function.  The  second  selects the type of plot. The third selects the type of
  71. security.  And  the fourth selects the data to be plotted. The <Esc> key may be
  72. pressed  at any of these to abort the program. Menus will be skipped if they do
  73. not apply to the function selected.
  74.  
  75.                              FIRST MENU - FUNCTION
  76.  
  77.            (1):  DOCUMENTATION
  78.  
  79.       This  appears  if the file PLTSTKFL.DOC is present on the active disk. It
  80. allows  you  to  read the documentation file without exiting BASIC or reloading
  81. the program.
  82.  
  83.            (2):  SINGLE FILE
  84.  
  85.       In this mode the program will ask you to specify a single securities file
  86. and  then will plot the data for that file, returning to BASIC when the plot is
  87. completed.
  88.  
  89.            (3): SINGLE TYPE
  90.  
  91.       If  PLTSEQFL.DAT  is  present, this mode will ask you to select a type of
  92. security  and  then  plot  all  files  listed  in PLTSEQFL.DAT for that type of
  93. security.
  94.  
  95.            (4): ALL FILES
  96.  
  97.       All  files  listed  in  PLTSEQFL.DAT  will  be  plotted.  The  securities
  98. selection menu will be skipped.
  99.  
  100.                              SECOND MENU - PLOT
  101.  
  102.       Selections  (1):  and (2): are for a continuous plot. The plot will start
  103. at  the  beginning  of  the  file  and run to the end. No provision is made for
  104. skipping  perforations  on  fan-fold  forms.  (I  use  teletype paper.) If your
  105. printer's  bit  switch  is  set for "1 inch skip over perf" you may get gaps in
  106. your  plots.  This  may also cause trouble in the 11 inch page mode, since this
  107. program  makes  full  use  of  the  page.  A space of two lines is left between
  108. successive  plots  in  this mode.
  109.  
  110.       Selections  (3):  and  (4):  limit  the  plot to an eleven inch page. The
  111. program  determines the number of entries in the data file, then plots the last
  112. 80  of  them  in  medium  resolution  mode, or the last 200 of them in the high
  113. resolution mode. In order to obtain this much data per page the spacing between
  114. pages  is  about 1/2 inch. Therefore align fan-fold paper carefully and be sure
  115. printer  bit  switch SW2-4 in the EPSON is off (its normal position). The paper
  116. is advanced to the top of the next form at the end of each plot.
  117.  
  118.       Selections  (1):  and (3): use compressed print and 1/8 inch line spacing
  119. to  produce plots with a resolution of 1/130 and eighty days per page. The date
  120. and relevant price or volume data are printed on each line.
  121.  
  122.       Selections  (2): and (4): use the EPSON's compressed script mode to print
  123. 130  points per line on a 1/18 inch line for 200 lines per page. Because of the
  124. overlapping of lines, the price or volume data is printed only for Fridays. The
  125. script  type  (superscript  or  subscript) is randomized for each run using the
  126. TIME$ function to equalize wear on the print head and ribbon.
  127.  
  128.       .
  129.                              THIRD MENU - SECURITY TYPE
  130.  
  131.       Selection of the type of security is necessary for the format of the plot
  132. since  the  data  files present different types of information and in different
  133. order for various markets. All of the formats are based on listings in The Wall
  134. Street Journal.
  135.  
  136.            (1):   Dow Jones Averages
  137.  
  138.       This   is  for  the  entries  from  the  tables  of  30  INDUSTRIALS,  20
  139. TRANSPORTATION,  15  UTILITIES  and  65 STOCKS COMPOSITE AVERAGE data. The data
  140. file format is actually the same as for selection (2) but this selection allows
  141. for handling the larger volumes and prices in the plot.
  142.  
  143.       The data file format is "date",volume,high,low,close.
  144.  
  145.            (2):   New York Stock Exchange
  146.  
  147.       Covers  the  data for the NYSE-Composite Transactions as well as New York
  148. Exchange  Bonds  and  Amex-Composite  Tranactions. On each line are plotted the
  149. daily  low,  high,  close,  average close, and the value that the average would
  150. have  become  since  the beginning of the plot at the market interest rate. The
  151. space  between the low and the high is darkened with "#" symbols and the offset
  152. of this bar from the average is filled with "-"'s
  153.  
  154.       The data file format is "data",volume,high,low,close.
  155.  
  156.            (3):  Over the Counter Markets
  157.  
  158.       This  format  covers  NASDAQ  quotes of the Over-the-Counter Markets. The
  159. plot  is  similar  to selection (2): except that there is no closing price. The
  160. spread between the bid and asked prices is filled with "#"'s. 
  161.  
  162.       The data file format is "date",volume,bid,asked,0.
  163.  
  164.            (4):  Options
  165.  
  166.       These files contain data for listed options. 
  167.  
  168.       It  is  important  for  options files that the last two characters of the
  169. filename  be  the  strike price of the option if this data is to be used by the
  170. program   PLTSTKFL.   An  example  is  BETHJA35  where  the  filespec  will  be
  171. BETHJA35.OPT.  In  plotting  options  data,  PLTSTKFL  extracts  the  last  two
  172. characters in the filename for use as a baseline in the plot. 
  173.  
  174.       The  plot  for  options is quite complex. The put and the call prices are
  175. scaled  independantly  to  fill  the  available  space  and  plotted  without a
  176. baseline.  They are bracketed by "#" symbols to make them stand out. The strike
  177. price  is  extracted  from the file name and is used as a baseline for relative
  178. price comparisons.
  179.  
  180.       Two  new data points are generated by subtracting the call price from the
  181. closing  price  and  by  adding  the put price to the closing price in the data
  182. file.  These  numbers  are  listed, with the date, on the left of the plot. The
  183. resulting  low,  strike, close, and high prices are scaled to fit the available
  184. space and plotted.
  185.  
  186.       The  space between the low and the close is filled with "-"'s and between
  187. close  and  high  with  "+"'s to tie them together. A study of this plot should
  188. provide considerable information about the behavior of options.
  189.  
  190.       The data file format is "date",0,call,put,close.
  191.  
  192.            (5):  Mutual Funds
  193.  
  194.       This  format  is  the  same as for Over-the Counter stocks except the Net
  195. Asset  Value  and  Offer  Price  are  plotted,  and  there  is  no  volume data
  196. available.
  197.  
  198.       The data file format is "date",0,nav,offer,0
  199.  
  200.       The  data  file formats above are what you will see if you list the files
  201. with  DOS  [type]  or  EDLIN.  The  null  (0)  entries are used to allow common
  202. subroutines to be used for search or conversion of all of the data types.
  203.  
  204.                              FOURTH MENU - DATA TO BE PLOTTED
  205.  
  206.       For  most  types  of  files both price and volume data is available. This
  207. menu lets you decide which you want plotted. 
  208.  
  209.                                    -
  210.  
  211.       Printing  will  start  after  the  last  menu selection is made. There is
  212. considerable  disk  activity and calculation with this program. Therefore speed
  213. will  be  considerably  improved with any or all of printer buffers, ram memory
  214. disk simulation, or a compiled version of this program.
  215.  
  216.                              DATA FILE GENERATION
  217.  
  218.       This  program is intended to be used with the program MAKSTKFL.BAS by the
  219. same  author.  However  you can create data files with EDLIN or other editor or
  220. write  a simple high level language yourself. The files are sequential with the
  221. folowing format on each line"
  222.  
  223.            "date",data-AA,data-BB,data-CC,data-DD
  224.  
  225.       The  location  of  the  values for each type of file is shown under THIRD
  226. MENU above. The date is a string variable in the form used by the BASIC [TIME$]
  227. command. The data is fixed point. An EDLIN listing would appear as follows:
  228.  
  229.            1:*"04-07-83",3598,24.5,21.25,23.875
  230.            2: "04-08-83",4259,26.25,23.125,25
  231.            3: "04-11-83",5983,27.875,25.625,26.625
  232.  
  233.       With  this  information  you  may be able to use this program without any
  234. other software.
  235.  
  236.  
  237.                              MISCELLANEOUS
  238.  
  239.       At the time of this writing this program is still in a fairly rough form.
  240. Most  work  is  needed  in  the  error  recovery routines from disk and printer
  241. faults.  Hwever  since the software only opens files for input, there is little
  242. likelyhood  of  loss  of  data  and  the  program  can always be restarted with
  243. <Ctrl>+<Break>. 
  244.  
  245.       Revisions  and companion programs will be made available through the user
  246. groups that distribute this program.
  247.  
  248.                              ---***---
  249.  
  250.  
  251.  
  252.       The program PLTSTKFL.BAS and its associated files are made freely
  253. available for non-exclusive distribution by the Picture City Personal Computer
  254. Programmers' Club and through exchange with other users groups as long as
  255. (PC)^3 and the author are fully credited.
  256.